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ABOUT THIS CHAPTER 


This chapter describes the Time Manager, the part of the Operating System that 


lets you schedule a routine to be executed after a given number of milliseconds 
have elapsed. 
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ABOUT THE TIME MANAGER 


The Time Manager provides the user with an asynchronous "wakeup" service with 
1-millisecond accuracy; it can have any number of outstanding wakeup requests. 
The Time Manager is independent of clock speed or interrupts, and should be used 
in place of cycle-counting timing Loops. 


An application can add any number of tasks for the Time Manager to schedule. 
These tasks can perform any desired action so long as they don't make any calls 
to the Memory Manager, directly or indirectly, and don't depend on handles to 
unlocked blocks being valid. They must preserve all registers other than AQ—A3 
and D0Q-D3. If they use application globals, they must also ensure that register 
A5 contains the address of the boundary between the application globals and the 
application parameters; for details, see SetCurrentA5 and SetA5 in Macintosh 
Technical Note #208. 


eeeClick on the X-Ref button, and refer to Technical Note #208. -¢ee 


Note: To perform periodic actions that do allocate and release memory, you 
can use the Desk Manager procedure SystemTask. 


Information describing each Time Manager task is contained in the Time Manager 
queue; you need only supply a pointer to the routine to be executed. The Time 
Manager queue is a standard Macintosh queue, as described in the Operating 
System Utilities chapter. Each entry in the Time Manager queue has the following 
structure: 


TYPE TMTask = RECORD 


qLink: QElemPtr; {next queue entry} 
qType: INTEGER; {queue type} 
tmAddr: ProcPtr; {pointer to routine} 
tmCount: INTEGER {reserved} 

END; 
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USING THE TIME MANAGER 


The Time Manager is automatically initialized when the system starts up. Since 
the "sleep" time for a given task can be as small as 1 millisecond, you need to 
install a queue element in the Time Manager queue before actually making the 
wakeup request; to do this, call InsTime. To make the actual wakeup request, 
call PrimeTime. When you're done, call RmvTime to remove the element from the 
queue. 
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TIME MANAGER ROUTINES 


PROCEDURE InsTime (tmTaskPtr: QElemPtr); 


Trap macro _InsTime 
On entry AO: tmTaskPtr (pointer) 
On exit DO: result code (word) 


InsTime adds the task specified by tmTaskPtr to the Time Manager queue. InsTime 
returns one of the result codes listed below. 


Result codes noErr No error 
PROCEDURE PrimeTime (tmTaskPtr,count: LONGINT); 


Trap macro PrimeTime 

On entry AQ: tmTaskPtr (pointer) 
DO: count (long word) 

On exit DO: result code ( word) 


PrimeTime schedules the routine specified by tmTaskPtr to be executed after 
count milliseconds have elapsed. The queue element must already be inserted into 
the queue by a call to InsTime before making the PrimeTime call. The PrimeTime 
routine returns immediately, and the specified routine will be executed after 
count milliseconds have elapsed. 


Result codes noErr No error 
PROCEDURE RmvTime (tmTaskPtr: QElemPtr); 
Trap macro —_RmvTime 

On entry AQ: tmTaskPtr (pointer) 


On exit DO: result code (word) 


RmvTime removes the task specified by tmTaskPtr from the Time Manager queue. 
RmvTime returns one of the result codes listed below. 


Result codes noErr No error 
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SUMMARY OF THE TIME MANAGER 


Data Types 
TYPE 
TMTask = RECORD 
qLink: QElemPtr; {next queue entry} 
qType: INTEGER; {queue type} 
tmAddr: ProcPtr; {pointer to routine} 
tmCount: INTEGER {reserved} 
END; 
Routines 


PROCEDURE InsTime (tmTaskPtr: QElemPtr); 
PROCEDURE RmvTime (tmTaskPtr: QElemPtr); 
PROCEDURE PrimeTime (tmTaskPtr,count: LONGINT); 


Assembly-Language Information 


Routines 
Trap macro On entry On exit 
InsTime AO: tmTaskPtr ) DO: result code (word) 


( 
_RmvTime AO: tmTaskPtr ( 
_ PrimeTime AO: tmTaskPtr ( 

DO: count (long 


ptr 

ptr) DO: result code (word) 
ptr) DO: result code (word) 
) 


Structure of Time Manager Queue Entry 


qLink Pointer to next queue entry 
qType Queue type (word) 

tmAddr Pointer to task 

tmCount Reserved (word) 
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Further Reference: 


Desk Manager 


OS Utilities 
Technical Note #180, MultiFinder Miscellanea 


Technical Note #208, Setting and Restoring A5 


END OF DOCUMENT 
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